home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / dev / misc / MakeTagBase.readme < prev    next >
Text File  |  2001-09-05  |  5KB  |  140 lines
  1. Short:    Make methods and tags bases 1.15 (21.06.01)
  2. Author:   Przemyslaw 'SENSEI' Gruchala <sensei@box43.gnet.pl>
  3. Uploader: Przemyslaw 'SENSEI' Gruchala <sensei@box43.gnet.pl>
  4. Version:  1.15 (21.06.01)
  5. Type:     dev/misc
  6. Replaces: dev/misc/MakeTagBase.lha
  7. Requires: OS 2.0+, any CPU
  8. Keywords: maketagbase redgroup sensei gruchala polska poland
  9.  
  10. WHAT'S THIS?
  11.    This is a small utility to create method and tag bases for BOOPSI and
  12.    MUI classes, libraries and normal applications.
  13.  
  14. DISCLAIMER
  15.    This software is provided as-is, without warranty of any kind, either
  16.    expressed or implied.  Under no circumstances will the authors be liable
  17.    for direct, indirect, incidental or consequential damages either to
  18.    hardware or software or data loss resulting from the use of MakeTagBase.
  19.    The entire risk as to the results of MakeTagBase is assumed by the user.
  20.  
  21. DESCRIPTION
  22.    MakeTagBase can work in two modes:
  23.  
  24.    1) Convert string to bases mode.  When you want to create new bases you
  25.    should write for example:
  26.  
  27.    MakeTagBase ID BLAH
  28.  
  29.    and if the ID is correct you'll receive for the example above:
  30.  
  31.    Converting ID "BLAH"...  Base 0x16A94880 TagBase 0x96A94880
  32.  
  33.    Now you can use 'Base' as a method dummy and 'TagBase' as tag base (it's
  34.    'Base' bit or TAG_USER).
  35.  
  36.    2) Convert bases to string mode.  It could be useful if you forgot what
  37.    string you used to create bases, or if you'd like to check MakeTagBase
  38.    or existing bases.  Example of usage:
  39.  
  40.    MakeTagBase BASE 0x16A94880
  41.  
  42.    Converting TagBase 0x16A94880... ID "BLAH"
  43.  
  44.    The template for MakeTagBase is ID,BASE=TAGBASE where ID is a four
  45.    character long string which contains upper case A-Z and 0-9 numbers.  If
  46.    other characters are present or the length is incorrect, an error will
  47.    occur.  BASE=TAGBASE is a base which you would like to convert to a
  48.    string.  It should start with 0x or $ if it's a hexadecimal number, and
  49.    with 0-9 if it's a decimal number.  In other cases an error will occur.
  50.    You can't use ID and BASE=TAGBASE at the same time!
  51.  
  52.    Note that any unused bits, like bit 31, are ignored by MakeTagBase.  So
  53.    MakeTagBase BASE 0x16A94880 and MakeTagBase TAGBASE 0x96A94880 will
  54.    produce the same result.
  55.  
  56.    Note that you're not allowed to use f.e.  "0000" as source string
  57.    because it'll be converted to 0!!!
  58.  
  59. HOW IT WORKS?
  60.    In making bases mode the specified string is packed to a long word
  61.    number (using special packing techniques (which you can learn on
  62.    request, but I doubt that anybody will mail me for it ;) ).  In making
  63.    string mode the specified long word number is unpacked to a string.
  64.  
  65. REGISTERED BASES
  66.    Currently "registered" bases are:
  67.  
  68.     - CMDL Base 0x18B1AA80 TagBase 0x98B1AA80 for command.library.
  69.  
  70.    If you're using this utility please contact me and I'll add your base
  71.    to this list, so nobody will use the same bases as you (it's important
  72.    to create unique bases f.e.  when you're writing MUI subclasses.  If two
  73.    or more objects use the same base, and are placed in one group, when you
  74.    use a method or set the attributes of one of these classes on a group
  75.    object, the attribute will be set only for the top object in the group
  76.    list!  In other words, it wont do what you want...  It's better to think
  77.    about this in the design stage, because when everyone is using your MCC
  78.    it's too late to change anything...).  "Registration" is free, so just
  79.    contact me.  And always download new versions of MakeTagBase when
  80.    they're released because they could contain a more recent list of
  81.    registered bases.
  82.  
  83. FUTURE
  84.    Anything you want, just contact me ;).
  85.  
  86.    New registered bases and bugs fixes if any.
  87.  
  88. HISTORY
  89.    1.15 (21.06.01):
  90.  
  91.       - First public version.
  92.  
  93.       - Better error handling (when there's no arguments specified it's now
  94.         reporting 'required argument missing' instead of 'wrong number of
  95.         arguments'.
  96.  
  97.    1.1 (17.06.01):
  98.  
  99.       - Cleanup the source code.  Better error handling (now it's using
  100.         dos.library error codes instead of custom ones).
  101.  
  102.       - No stdio printf() routines any more!  It's using dos.library
  103.         instead.  The result is 2.5 times smaller executable file...
  104.  
  105.       - Fixed BASE=TAGBASE mode (which stopped working after using
  106.         dos.library Printf() because I used %c instead of %lc ;).
  107.  
  108.       - BASE=TAGBASE now accepts several types of tagbases:  if it starts
  109.         with 0x or $, base is in hexadecimal format and if first character
  110.         is between 0 and 9, base is in decimal format.
  111.  
  112.       - Compiled with size optimization turned on using SAS/C v6.58.
  113.  
  114.    1.01 (24.08.00):
  115.  
  116.       - Some fixes are made (I don't remember what exactly).
  117.  
  118.    1.0 (??.08.00):
  119.  
  120.       - First internal version.
  121.  
  122. AUTHOR
  123.    Idea, testing and main programmer:
  124.  
  125.       Przemyslaw 'SENSEI' Gruchala <sensei@box43.gnet.pl>
  126.  
  127.    English support:
  128.       Stephen Brookes <sbrookes@tpec.freeserve.co.uk>
  129.  
  130.  
  131. ============================= Archive contents =============================
  132.  
  133. Original  Packed Ratio    Date     Time    Name
  134. -------- ------- ----- --------- --------  -------------
  135.     1671     987 40.9% 17-Jun-01 05:46:30  MakeTagBase.info
  136.     5228    3211 38.5% 20-Jun-01 05:55:50 +MakeTagBase
  137.     4930    2259 54.1% 21-Jun-01 02:30:30 +MakeTagBase.readme
  138. -------- ------- ----- --------- --------
  139.    11829    6457 45.4% 12-Jul-101 19:20:10   3 files
  140.